General Settings view

To open the General Settings view, click the General Settings button on the IMEX, GEM or STARS sub-strips.

The simulation data in this view does not belong to any of the other data types. The reporting and restart intervals are defined in the general settings as well as water properties and a number of other special parameters. The keywords *DI, *DJ, and *DK are required keywords (except for *CORNER).  You enter the dimensions of the grid blocks using these three keywords.  Array reading options must be used with these keywords.

The master table for the general settings view is the deck. Normally there is one deck in each simulation case. Additional decks can be added. Only one deck can be marked active. The active deck is the one that is built, is displayed on the explorer, and whose tables are displayed in other input views. 

Deleting a row from the master table in the General Settings view has simulation case wide implication. The deck is the parent of all other rows in the dataset; therefore, deleting a deck will delete all associated data, including wells, faults, etc. This is all data inside the simulation case; the static model is unaffected by any deletion operation in the simulation case.

General Settings view tabs

The General Settings view includes the following tabs:

General  general parameters including case titles, unit.

Includes  include file generation settings.

Times  list of times included in the deck.

Options  special features of the simulator that are not often used.

Results File  controls which information is sent to the results file, which is read after the simulation run.

Output File  controls which information is sent to the output file, which is shown during the execution of a simulation.

Numerical  numerical methods control section.

Key fields and categories of the General tab:

TITLE1  Text field used for project identification, this is an optional field.

TITLE2  Text field that can be used for project identification in addition to TITLE1, this is an optional field.

TITLE3  Text field that can be used for project identification in addition to TITLE1 and TITLE 2, this is an optional field.

Case ID  Can be used to further identify the case (i.e. specific case runs or versions).

Input Data Units(INUNIT)  Controls the units in which the deck is written. This does not influence the units within the application.

Output Data Units(OUTUNIT)  Controls the units in which the output file is written. This does not influence the units within the application.

Data range checking (RANGECHECK)  Controls the data range check feature.

Echo all lines (LIST/NOLIST)  Controls the listing of the input data file to the output print file.

Maximum number of Errors (MAXERROR)  The maximum number of error messages before the simulation terminates.

Frequency of rewinding the restart file (REWIND)  Controls the frequency of rewinding the rewindable-results-file. The number defined here is the maximum number of restart records allowed before the rewindable-restart-record is rewound.

Key columns of the Includes tab:

Data section  Include file type, indicates the type of data that is contained in the include file. One of PVT, Reservoir Description Geometry, Reservoir Description Properties, Component (GEM™ and STARS™ only), Rock-Fluid, Initial Conditions, Numerical Control, and Recurrent Data.

Mode  The following options are available:

  • Generate data within main input file JewelSuite creates the content of the data section and writes it directly into the main simulation input file (*.DAT).
  • Generate and use new include file JewelSuite creates the content of the data section in a separate include file (*.inc) and references it in the main simulation input file with an INCLUDE statement.
  • Use existing include file This option allows you to browse and select an external include file (*.inc). The file path will be added to the main simulation input file via an INCLUDE statement.
    It is recommended to store your external include file in a directory other than the cases folder (*.Cases) to maintain better organization and avoid potential conflicts.
  • Exclude data from input data set This option allows you to omit the entire data section and no data will be written to the main simulation input file.
While defining a simulation case for STARS™, you must provide the Component include file and this file cannot be generated by JewelSuite Subsurface Modeling.

Path  Path to include file. Required for Generate and Include modes. Path can be absolute only for Include mode. Path must be relative and contain no “..” elements for generate.

The Times tab is used to enter and modify time table entries for the simulation. The simulation will run until the greatest active time in the time table is reached.

The Active column is used to designate active times. Times are, by default, active. By setting the active check box off for a time, that time is excluded from the generated deck. Deleting an entry in the time table deletes all child records. Child records include well configuration, well constraints, and many other records.  Conversely, when records on child tables are created for new times, those times will appear in the time table.

When a time or date is changed in a record on the time table, the modified time or date is reflected on the child table. In other words, the child records are moved in time by changing the time on the time table.

Either times, dates, or both can be entered on a record in the time table. Inconsistencies will be rectified during deck validation. Dates can only be entered if a starting date was specified for the simulation. If a date is entered, the corresponding time will be calculated during validation. Times are always in days.

Right-clicking in the table will display a context menu with options for adding standard reporting or standard restart values into the table:

Daily  Adds a reporting time for each day in between the start and stop dates.

Monthly  Adds a reporting time for each month in between the start and stop dates.

Quarterly  Adds a reporting time for each quarter in between the start and stop dates.

Yearly  Adds a reporting time for each year in between the start and stop dates.

Custom  When this option is selected, the Create Interpolated Times dialog will appear. In this dialog, the start and stop time can be specified and a custom interpolation interval defined. The interval can be based on seconds, minutes, hours, days or weeks.

The Options Tab is used to specify various program options:

Run Time Dimension (DIM)  Specifies a dimensioning variable with a value.

Write in External Data Representation(XDR)  The binary (data) file may be written in external data representation (XDR) format as well as the binary format native to your platform. Use of XDR allows the SR2 binary file(s) to be written on one platform and read on another. Binary files are currently not supported in the application.

Output file options (FILENAME(S))  Controls the various files to which output is written.

Only check data set for errors (CHECKONLY)  When selected, well data will be checked for errors. Simulation will not run.

The Results file tab specifies the writing frequency and what items to write to the simulation index results file. It also controls the options for the results file. The first timestep size to be used immediately after the current well change can be set here. The simulation result file name will consist of root name of the input file plus the results file extension (depending on your simulator).

WSRF  Controls the writing of well and/or grid information to the index-results-file and the main-results-file.

OUTSRF  Identifies what information is written to the index-results-file and the main-results-file.

DTWELL  Identifies the first timestep size to be used immediately after the current well change.

DTMAX  Maximum time step size.

DTMIN  Minimum time step size.

The Output file tab specifies the frequency of the simulation output file writing and what items will be in the simulation output file or *.out. The simulation output file name consists of the root name of the input file plus .out extension. Some of the information written can be controlled using the OUTDIARY option. The output file is written to the output view during the simulation run.

WPRN  Controls the frequency of written data to the output file.

OUTPRN  Identifies what information is written to the output file.

OUTDIARY (IMEX™ only) Controls some of the information written to the output diary file.

WRST  Controls the frequency of writing restart records to the index-results-file and to either the main-results-file or the rewindable-results-file.

The Numerical Tab is used to set the Numerical methods section of a deck.

NORTH  Controls the maximum number of orthogonalizations to be performed before resetting for the iterative solution method.

PIVOT  Controls the diagonal submatrix inversion pivot stabilization.

PPATTERN  Sets the basic partitioning of the reservoir into non-connected regions and separators that makes possible the parallelization of the linear solution.

PRECC  PRECC is used to specify the convergence tolerance for the linear equation solver (AIMSOL).

SDEGREE  Controls the maximum degree of fill terms used in the factorization.

AIM  Controls the adaptive implicit switching option.

SORDER  Controls the ordering of equations in ILU factorization.

ITERMAX  Used to specify the maximum number of iterations allowed in the Jacobian matrix solution routine.

MAXSTEPS  Used to specify the maximum number of timesteps for the simulation run.

NCUTS  Controls the number of timestep size cuts allowed in a single timestep.

NEWTONCYC  Used to specify the maximum number of Newtonian cycles.

DTMIN  Identifies the minimum timestep size.

DTMAX  Identifies the maximum timestep size.

Typical changes in the basic variables during a timestep (*NORM) subsection

NORM*  Identifies the typical changes in the basic variables over a timestep.

Maximum change in the basic variables during a timestep (*MAXCHANGE) subsection

MAXCHANGE*  Identifies whether a time step is cut if the maximum change in pressure or saturation is greater than that specified by *MAXCHANGE.

Parallel Processing Keywords subsection

DPLANES  Target number of planes per Jacobian domain.

PNTHRDS  Defines the number of threads to be used for the simulation.

SOLVER  Defines the solver type to be used: AIMSOL or PARASOL.

PNPROSL  Number of scaling and GMES vector operations per class.

PDEGAA  Defines the factorization degree within PARASOL classes.

PDEGAB  Defines the factorization degree to be used between PARASOL classes.

CHECKRB  When selected, the red-black ordering is abandoned for PARASOL classes in which the fraction of red blocks is too small.

JACPAR  Defines the target number of Jacobian domains.

The convergence criteria for Newton's Method can be specified in this tab.

PRESS  Indicates changes in convergence tolerance for pressure.

SATUR  Indicates changes in convergence tolerance for saturation.

MAXRES  Indicates the maximum scaled residual allowed for any single equation at convergence.

MAXRES OIL  The value specified here is applied to oil equations.

MAXRES WATER  The value specified here is applied to water equations.

MAXRES GAS  The value specified here is applied to gas equations.

MAXRES SOLVENT  The value specified here is applied to solvent equations.

MAXRES POLYMER  The value specified here is applied to polymer equations.

MAXRES LIGHTOIL  The value specified here is applied to the API tracking light oil component.

MAXRES SEAWATER  The value specified here is applied to seawater equations.

MAXRES OTHER  The value specified here is applied to solvent, polymer, seawater or light oil component equations.

TOTRES  Indicates the maximum average scaled residual for all equations for a particular phase or component. (i.e. the average of all oil equations in IMEX, or the average of all flow equations for a particular component in GEM).

WELLRES  Indicates the maximum scaled residual allowed for any single well equation at convergence.